home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xm / XmeDragSource.z / XmeDragSource
Encoding:
Text File  |  2002-10-03  |  9.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee - A toolkit function that starts a drag and
  10.           drop operation
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/TransferP.h>
  14.           WWWWiiiiddddggggeeeetttt XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           XXXXttttPPPPooooiiiinnnntttteeeerrrr llllooooccccaaaattttiiiioooonnnn____ddddaaaattttaaaa,
  17.           XXXXEEEEvvvveeeennnntttt ****eeeevvvveeeennnntttt,
  18.           AAAArrrrggggLLLLiiiisssstttt aaaarrrrggggssss,
  19.           CCCCaaaarrrrddddiiiinnnnaaaallll aaaarrrrgggg____ccccoooouuuunnnntttt);
  20.  
  21.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  22.           This page documents Motif 2.1.
  23.  
  24.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  25.           XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee begins a drag and drop operation from the
  26.           specified widget.
  27.  
  28.           This routine first asks the widget to convert the
  29.           ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPPselection to ____MMMMOOOOTTTTIIIIFFFF____EEEEXXXXPPPPOOOORRRRTTTT____TTTTAAAARRRRGGGGEEEETTTTSSSS.  The returned
  30.           list of targets becomes the initial value of the
  31.           DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss, and the number of targets
  32.           becomes the initial value of the DragContext's
  33.           XXXXmmmmNNNNnnnnuuuummmmEEEExxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss.
  34.  
  35.           The _l_o_c_a_t_i_o_n__d_a_t_a argument contains information about the
  36.           location of the elements being dragged.  If these consist of
  37.           the widget's current selection, the value is _N_U_L_L.
  38.           Otherwise, the type and interpretation of the value are
  39.           specific to the widget class.  The _l_o_c_a_t_i_o_n__d_a_t_a argument
  40.           becomes the value of the DragContext's XXXXmmmmNNNNcccclllliiiieeeennnnttttDDDDaaaattttaaaa and of
  41.           the _l_o_c_a_t_i_o_n__d_a_t_a member of the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt for
  42.           subsequent conversions of the data being dragged.
  43.  
  44.           XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee sets the DragContext's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc to a
  45.           function that asks the widget to convert data.
  46.  
  47.           This routine calls XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt with the widget specified in
  48.           _w_i_d_g_e_t, the event specified in _e_v_e_n_t, and the arguments
  49.           specified in _a_r_g_s.  It overrides any settings of
  50.           XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss, XXXXmmmmNNNNnnnnuuuummmmEEEExxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss, XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc, and
  51.           XXXXmmmmNNNNcccclllliiiieeeennnnttttDDDDaaaattttaaaain _a_r_g_s.
  52.  
  53.           Whenever this routine or a subsequent drop operation asks a
  54.           widget to convert data, it makes the following sequence of
  55.           calls:
  56.  
  57.              1. Calls the application's XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedures,
  58.                 if any.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee((((3333XXXX))))         UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV         XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.              2. Calls the source widget's ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method.
  75.                 However, if any XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns
  76.                 XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____DDDDOOOONNNNEEEE or XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____RRRREEEEFFFFUUUUSSSSEEEE, then
  77.                 XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee will not call ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc.
  78.  
  79.           _w_i_d_g_e_t    Specifies the widget that is the source for the
  80.                     data.
  81.  
  82.           _l_o_c_a_t_i_o_n__d_a_t_a
  83.                     Specifies the location of the elements being
  84.                     dragged.  If these consist of the widget's current
  85.                     selection, the value is _N_U_L_L.  Otherwise, the type
  86.                     and interpretation of the value are specific to
  87.                     the widget class.
  88.  
  89.           _e_v_e_n_t     Specifies the event that began the drag operation.
  90.  
  91.           _a_r_g_s      Specifies arguments to be passed to XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt.
  92.  
  93.           _a_r_g__c_o_u_n_t Specifies the number of arguments in _a_r_g_s.
  94.  
  95.      RRRREEEETTTTUUUURRRRNNNN
  96.           This function returns the widget ID of the XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt
  97.           returned by XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt.
  98.  
  99.      RRRREEEELLLLAAAATTTTEEEEDDDD
  100.           XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt(3), XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3),
  101.           XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3),
  102.           XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3),
  103.           XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3),
  104.           XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
  105.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3),
  106.           XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and
  107.           XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.